Repository navigation
feat(docs): cloudhal.dev on Starlight over the repo's docs (RFC-0037 phase 1) - #35
Merged
Merged
Conversation
…phase 1) apps/docs is now an Astro Starlight site whose pages come from the monorepo's docs/ through a custom content loader: titles from the H1, descriptions from the Summary or Context, relative links rewritten to site paths (or GitHub for files outside docs/), a generated RFC index. The post-build step adds, from the same page list: - every page as Markdown at <path>.md and <path>/index.md; - /llms.txt and /llms-full.txt, plus a pair per section; - the JSON Schemas at their $id URLs (unchanged); - _redirects from src/lib/redirects.ts (301s; /docs/deploy kept). Pagefind search, a sidebar with guides, contributing, ADRs and RFCs, and tests for the loader, the link rewriting and the link contract. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Madraka <8898640+Madraka@users.noreply.github.com>
Rendering two widths full page took over the 20 s default on loaded runners and failed this PR twice; the tests allow 60 and 90 s. The production default is unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Madraka <8898640+Madraka@users.noreply.github.com>
5 tasks done
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Phase 1 of RFC-0037 / ADR-0039.
apps/docsreads the monorepo'sdocs/through a custom loader (src/lib/repo-docs.ts): H1 → title, Summary/Context → description, relative links → site paths or GitHub, generated/docs/rfcsindex. 98 pages: home,/docs,/fetch, guides, contributing, all ADRs and RFCs with their status.<path>.mdand<path>/index.md(absolute links, frontmatter withurlandsource),/llms.txt,/llms-full.txt, andllms.txt/llms-full.txtper section.src/lib/redirects.ts(301),/docs/deploykept; a test fails on any internal link to a page that does not exist./fetchkeep their URLs.Checked locally on
wrangler dev: every route, the sidebar at 1440 px and on a phone, no sideways scroll, no broken internal links. Deploy after merge.🤖 Generated with Claude Code